package com.hzw.saas.common.storage.service;

import java.io.File;
import java.io.IOException;
import java.io.OutputStream;
import java.util.List;

/**
 * S文件服务
 */
public interface IS3FileService {

    /**
     * 文件上传
     *
     * @param file
     * @param fileKey
     * @return
     * @throws IOException
     */
    String uploadFile(File file, String fileKey) throws IOException;

    String uploadFile(File file, String fileKey, String bucket) throws IOException;

    /**
     * 文件下载
     *
     * @param fileKey 唯一文件名(可通过http://domain/fileKey访问)
     * @param tarPath 下载至路径
     */
    void downloadFile(String fileKey, String tarPath) throws IOException;

    /**
     * 文件下载
     *
     * @param fileKey 唯一文件名(可通过http://domain/fileKey访问)
     * @param ous     下载的输出流
     * @throws IOException e
     */
    void downloadFile(String fileKey, OutputStream ous) throws IOException;

    /**
     * 文件下载
     *
     * @param fileKey   唯一文件名(可通过http://domain/fileKey访问)
     * @param ous       下载的输出流
     * @param skipBytes 跳过字节数，大于0时有效
     * @throws IOException e
     */
    void downloadFile(String fileKey, OutputStream ous, long skipBytes) throws IOException;

    /**
     * 查看文件是否存在
     */
    boolean exists(String dir);

    boolean exists(String key, String bucket);

    /**
     * 获取所有的文件列表
     *
     * @param dir
     * @return
     */
    List<String> getAllFileByDir(String dir);

    /**
     * 文件删除
     *
     * @param fileKey
     */
    void deleteFile(String fileKey);

    /**
     * 批量删除
     *
     * @param keys
     */
    void deleteFiles(List<String> keys);

    /**
     * 创建目录
     *
     * @throws IOException
     */
    void createDir(String dir) throws IOException;

    /**
     * 删除目录
     *
     * @throws IOException
     */
    void deleteDir(String dir) throws IOException;

    /**
     * 重命名
     *
     * @throws IOException
     */
    void rename(String srcPath, String targetName) throws IOException;

    /**
     * 文件移动
     *
     * @throws IOException
     */
    void mv(String srcPath, String targetPath) throws IOException;

}
